MCP Server Playwright

A Model Context Protocol server that provides browser automation capabilities using Playwright
_{Enable LLMs to interact with web pages, take screenshots, and execute JavaScript in a real browser environment}

Table of Contents

• Features
• Installation
• Configuration
• Components
  • Tools
  • Resources
• License

Features

• 🌐 Full browser automation capabilities
• 📸 Screenshot capture of entire pages or specific elements
• 🖱️ Comprehensive web interaction (navigation, clicking, form filling)
• 📊 Console log monitoring
• 🔧 JavaScript execution in browser context

Installation

npx playwright install
npm install -g @automatalabs/mcp-server-playwright

Configuration

To use the Playwright server with Claude Desktop, add the following configuration:

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": ["-y", "@automatalabs/mcp-server-playwright"]
    }
  }
}

Components

Tools

playwright_navigate

Navigate to any URL in the browser

{
  "url": "https://stealthbrowser.cloud"
}

playwright_screenshot

Capture screenshots of the entire page or specific elements

{
  "name": "screenshot-name",     // required
  "selector": "#element-id",     // optional
  "fullPage": true              // optional, default: false
}

playwright_click

Click elements on the page

{
  "selector": "#button-id"
}

playwright_hover

Hover over elements on the page

{
  "selector": "#menu-item"
}

playwright_fill

Fill out input fields

{
  "selector": "#input-field",
  "value": "Hello World"
}

playwright_select

Select an option in a SELECT element

{
  "selector": "#dropdown",
  "value": "option-value"
}

playwright_evaluate

Execute JavaScript in the browser console

{
  "script": "document.title"
}

Resources

1. Console Logs (console://logs)

   • Access browser console output in text format
   • Includes all console messages from the browser

2. Screenshots (screenshot://<name>)

   • Access PNG images of captured screenshots
   • Referenced by the name specified during capture

License

This project is licensed under the MIT License - see the LICENSE file for details.